Repository navigation
0.3.3.post1: fix GitHub MathJax rendering across docs - #59
Merged
Merged
Conversation
FonaTech
force-pushed
the
release-0.3.3
branch
from
November 13, 2026 18:36
e8ba444 to
86f2fe8
Compare
GitHub's MathJax configuration disallows \operatorname, leaves \!
(negative thin space) as a literal '!', and trips on a bare 'h^*'
superscript inside an aligned block. Together these cascaded into
equations K.4-K.9 of docs/KERNEL_ARCHITECTURE.md showing as raw text
and eq (3) of docs/LAZY_EXPERTS.md losing its multiplication sign.
Fixes (docs/, 10 files):
- \operatorname{X} -> \mathrm{X}; \operatorname*{X}_y ->
\mathop{\mathrm{X}}\limits_y (preserves limit position).
- Bare h^* -> h^{\ast}.
- Drop \! everywhere in math (ATTENTION, CLUSTER_LOCALITY,
LAZY_EXPERTS, LONG_CONTEXT, SPEC_DECODE, THEORY).
- LAZY_EXPERTS eq (3) rewritten as Q = max(1, 2d), d = \texttt{prefetch\_depth},
and the RAM-budget expression as B * 2^20 / p_page, B = \texttt{ram\_budget\_mb},
to avoid \mathrm{...\_...} MathJax ambiguity.
Version string unchanged at 0.3.3: docs are not shipped in the wheel
(MANIFEST.in and setuptools packages.find exclude them), so the PyPI
0.3.3 release remains valid; only the GitHub v0.3.3 tag needs to
point at this fix.
Matplotlib-mathtext strings in docs/assets/arch/make_arch.py and the
generated SVG XML comments are unaffected (different renderer).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
FonaTech
force-pushed
the
release-0.3.3
branch
from
November 13, 2026 18:42
86f2fe8 to
062f35f
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Docs-only post-release. No kernel, trainer, planner, auto-tune, Web UI, serving or wheel-content changes relative to 0.3.3.
Problem
GitHub's MathJax configuration disallows `\operatorname`, and a bare `h^*` superscript inside an `aligned` block in `docs/KERNEL_ARCHITECTURE.md` cascaded into equations K.4-K.9 showing as raw text on github.com. Visible symptoms the user hit:
Fix
Audit
Repo-wide scans after the fix: zero `\operatorname` in docs, zero disallowed macros, zero CJK-adjacent dollar boundaries, zero unsupported math environments, every `\tag` inside its `$$` fences, every `$$` fence paired.
🤖 Generated with Claude Code